<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html;charset=iso-8859-1">
<title>Installing and Uninstalling</title>
<style type="text/css"> <!-- @import url(1_.css);   --> </style>
<link disabled rel="stylesheet" type="text/css" href="1_.css">
</head>
<body bgcolor="#ffffff" text="#000000" link="#008000" vlink="#008000" alink="#008000">
<table cellspacing="0" cellpadding="0" border="0">
  <tr>
    <td align="center" valign="middle" width="50"><a name="Top">
    <a href="0_Index.htm"><img src="images/thco35_s.gif" border="0" width="32" height="32" alt="Chem.Eq.Diagr"></a>&nbsp;</td>
    <td align="left" valign="middle"><font size="-1"><a href="0_Index.htm">Chemical Equilibrium Diagrams</a></font></td>
  </tr>
</table>

<h2></a>DATABASE/SPANA:  Installing and Uninstalling</h2>

<ul>
<li><a href="#Distri">Distribution and installing</a></li>
<li><a href="#INI">INI-files</a></li>
<li><a href="#File_ass">File associations</a></li>
<li>Installing on a:
<ul>
<li><a href="#Run_Netw">Network server</a></li>
<li><a href="#Run_CDROM">CD-ROM</a></li>
<li><a href="#Run_USB">USB memory</a></li>
</ul>
</li>
<li><a href="1_Problems.htm">Problems when running DATABASE/SPANA?</a></li>
<li><a href="#Uninstall">Uninstalling</a></li>
</ul>

<a name="Distri"></a>
<hr><!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->

<h3>Distribution and installing:</h3>

<p>The software is distributed through the Internet at:</nobr></p>

<p class="indent"><a class="www" target="_blank" href="http://www.kemi.kth.se/medusa/">www.kemi.kth.se/medusa</a></p>

<p class="indent"><a class="www" target="_blank" href="https://sites.google.com/site/chemdiagr/">sites.google.com/site/chemdiagr/</a></p>

<ul style="margin-top:10pt">
<li><b>Windows:</b> the setup program allows you to make either a standard
or a <a href="#Run_USB">portable</a> installation.
For a standard installation the setup program will make a program group
<nobr>(&#147;Equilibrium</nobr> <nobr>Diagrams (java)&#148;)</nobr>
with the necessary icons (shortcuts). Optionally it will also associate
&#147;plt&#148; and  &#147;dat&#148; files with
<a href="S_0_Main.htm">SPANA</a>.
You can later change these file associations using the menu &#147;Preferences /
General options&#148; in SPANA.</li>
<li><b>Ubuntu (Linux):</b> Copy the zip file to your home directory (&#126;).
Double click to open the archive (zip-file).
Click on the Extract button (twice).
The software will be copied to folder <nobr>&#147;Eq-Diagr&#148;.</nobr>
Close the Archive Manager. Delete the distribution zip archive.

<p>Shortcut icons are copied to the Desktop folder.
To allow executing the desktop's shortcut icons as programs
you must either:
<ul>
<li>run the following command in a console terminal
   (type <nobr>Ctrl-Alt-T</nobr> to open a console):<br>
	 <tt>&nbsp;&nbsp;</tt><code>chmod +x ~/Desktop/*.desktop</code></li>

<li>or right-click on a shortcut, select "Properties",
   select the &#147;Permissions&#148; pane,
   and check &#147;Allow executing file as program&#148;.</li>
</ul>
The icon pictures will be updated after you <nobr>log-out</nobr>/<nobr>log-in,</nobr>
or if resized.</p></li>
<li><b>Mac OS X:</b></li>
</ul>

<a name="INI"></a>
<table width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td><hr> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
</td><td width="20" align="right">
<a href="#Top">
<img src="images/Upp.gif" alt="top" title="top" height="15" width="15" border="0"></a>
</td></tr></table>

<h3 style="margin-top:0">INI-files and Environment Variables</h3>

<p><b>&#147;ini&#148;-files</b> <nobr>(<tt>Spana.ini</tt></nobr> and
<nobr><tt>DataBase.ini</tt>)</nobr> keep track of the user&rsquo;s preferences,
the default directory, the databases, etc. &#147;Ini&#148;-files are created in the
installation directory. However, if the programs are installed on a
<b>Network</b> disk or on a <b>CD</b>, then the &#147;ini&#148;-files in the installation
directory will be read-only, and the programs will try to save 
the user&rsquo;s preferences in directories specified
in environment variables, etc. The sequence is:
<ul type="disc">
<li>The installation directory</li>
<li><nobr><tt><b>%APPDATA%</b></tt></nobr></li>
<li><nobr><tt><b>%HOMEDRIVE%%HOMEPATH%</b></tt></nobr></li>
<li><nobr><tt><b>%HOME%</b></tt></nobr></li>
<li><nobr>The user's home directory (system dependent)</nobr></li>
</ul>
A warning message is displayed if no &#147;ini&#148;-file is found
or if it can not be written anywhere.</p>

<p><b>DATABASE:</b> if an &#147;ini&#148;-file <nobr>(<tt>DataBase.ini</tt>)</nobr>
is found in the installation directory (that is, where
<tt>DataBase.jar</tt> is found) then this file is always used to read dabase
names and some other options. On a <b>Network</b> server this file would contain
settings common for all users. A&nbsp;personal &#147;ini&#148;-file
(in <nobr><tt>%APPDATA%</tt></nobr> or <nobr><tt>%HOME%</tt>,</nobr> etc) then supplies
only the default directory, the start position of the DATABASE-window, etc, for each user.</p>

<a name="File_ass"></a>
<table width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td><hr> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
</td><td width="20" align="right">
<a href="#Top">
<img src="images/Upp.gif" alt="top" title="top" height="15" width="15" border="0"></a>
</td></tr></table>

<h3 style="margin-top:0">File associations</h3>

<p>On <b>Windows,</b> files with extension &#147;plt&#148; and
&#147;dat&#148; may be automatically
associated with <a href="S_Interacting_w_Windows.htm">SPANA</a> when running the setup program.
However, these associations might be in conflict with other software.
To <u>remove</u> file associations use the <i>advanced</i> program level
in the menu &#147;Preferences / <nobr>General
options&#148;</nobr> in SPANA.</p>

<a name="Run_Netw"></a>
<table width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td><hr> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
</td><td width="20" align="right">
<a href="#Top">
<img src="images/Upp.gif" alt="top" title="top" height="15" width="15" border="0"></a>
</td></tr></table>

<h3 style="margin-top:0">Installing on a Network server</h3>

<p>All the files and sub-directories created during the installation can
be moved by the system administrator to a network disk,
which should be read-only to normal users. Alternatively the software could be
installed directly to the final location by the administrator. 
Shortcuts should be modified, if necessary, to point to the correct location
<nobr>(i.e.,</nobr> to the network directory), and then
copied for each user, depending on the system.
Environment variables should be defined
so that <a href="#INI">&#147;ini&#148;-files</a> may be saved.
</p>

<a name="Run_CDROM"></a>
<h3 style="margin-top:0">Installing on a CD-ROM</h3>

<p>Follow the instructions below for a USB memory</p>
<p>
&#147;Ini&#148;-files will be created when you run the software as indicated
<nobr><a href="#INI">above</a>.</nobr> Because the CD is a read-only memory,
&#147;ini&#148;-files will be created locally in the computer where the CD is inserted.
If you do not want this: before burning the CD run first SPANA and DATABASE from
the hard-disk, then edit the configuration files created
<nobr>(<tt>Spana.cfg</tt></nobr> and <nobr><tt>DataBase.cfg</tt>):</nobr>
change <tt>SaveIniFileToApplicationPath</tt>
from <tt>false</tt> to <tt>true</tt> and burn these files also to the CD.
</p>

<a name="Run_USB"></a>
<h3 style="margin-top:0">Installing on a USB memory</h3>

<p>The programs may be installed on any removable memory.</p>
<p><b>Windows:</b> Choose the option &#147;Portable application&#148; in the setup program.</p>
<p>If the <nobr>&#147;<a class="www" target="_blank" href="http://PortableApps.com">PortableApps.com</a>&#148;</nobr>
plattform is found on the removable drive Spana/Database will be installed following the
<a class="www" target="_blank" href="http://portableapps.com/about/what_is_a_portable_app">portable apps</a>
directory structure.
Otherwise to run Spana you can for example open the USB directory with the file explorer
and double-click on the file &#147;<tt>Spana&shy;<nobr>Portable.exe</tt>&#148;.</nobr></p>
<p><b>Ubuntu (Linux):</b> just copy the files to the removable drive.</p>
<p><b>Mac OS X:</b> just copy the files to the removable drive. If the JRE (Java
Runtime Enviroment) is installed on the local Macintosh, then
double-clicking on a &#147;jar&#148;-file in the USB memory will
start the program.</p>

<p style="margin-bottom:0">
For all systems: <nobr><a href="#INI">&#147;ini&#148;-files</a></nobr> will be created
on the USB memory when you run the software.</p>

<a name="Uninstall"></a>
<table width="100%" cellspacing="0" cellpadding="0" border="0">
<tr><td><hr> <!-- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -->
</td><td width="20" align="right">
<a href="#Top">
<img src="images/Upp.gif" alt="top" title="top" height="15" width="15" border="0"></a>
</td></tr></table>

<h3 style="margin-top:0">Uninstalling</h3>

<ul style="margin-top:10pt">
<li><b>Windows:</b>
<ul>
<li> Several possibilities:
<ol Type="a">
<li>Run the &#147;Uninstall&#148; program.
The shortcut is found in the Start-menu program group (normally
&#147;Equilibrium <nobr>Diagrams&#148;).</nobr></li>
<li>Alternative: open the installation directory with the file explorer and
double-click on the file <nobr>&#147;Uninstall.exe&#148;.</nobr></li>
<li>It should also be possible to use the &#147;add-remove programs&#148; function
in Windows&rsquo; control panel, but this might not work if you installed
the software in two or more locations in the same computer.</li>
</ol>
</li>
<li>
Any of these methods will remove the files installed, as well as shortcuts,
&#147;ini&#148;-files, file associations and registry keys.</li>

<li><p><u>If you installed the software in two or more locations in the same computer</u>,
then <nobr>&#147;Uninstall.exe&#148;</nobr> will only remove the files in
its own installation directory. But it will remove <u>all shortcuts,</u>
as well as file associations, registry keys, and any &#147;ini&#148;-files created
outside the installation directory as indicated <nobr><a href="#INI">above</a>.</nobr>
Note that <u>all program groups</u> in the Start-menu are searched for
&#147;Spana&#148; and &#147;Database&#148; short-cuts, even if they point to
other installation directories. After deleting the short-cuts
the program groups are deleted if empty.</p>
<p style="line-height:2.5ex; margin-top:0.5ex; margin-bottom:0.5ex; text-indent:0;">
After uninstalling in one location,
you will need to use the procedure described above under &#147;b&#148;
to uninstall the software from other locations in the same computer</p></li>

<li>As a last option you could delete the installation directory
(normally <nobr><tt>C:\Program\Eq-Diagr</tt>)</nobr>
with all its files and sub-directories, but this will <u>not</u> remove shortcuts,
file associations, registry keys nor &#147;ini&#148;-files outside the
installation directory.</li>
</ul>
</li>
<li><b>Removable drives (USB memory):</b>  just delete the installation
directory with all its files. Remember to back-up any data files and diagrams
you might have stored in that folder!</li>
<li><b>Ubuntu (Linux):</b> Delete the installation folder, but remember to back-up
any data files and diagrams you might have stored in that folder!
Delete also the Desktop's shortcuts.</li>
<li><b>Mac OS X:</b> Move the application to the Trash bin.</li>
</ul>

<p style="text-align:right; line-height:0; margin-top:0; margin-bottom:0">
<a href="#Top"><img src="images/Upp.gif" alt="top" title="top" height="15" width="15" border="0"></a>
</p>
</body>
</html>